# Yocto Linux

***Copyright © Quectel Wireless Solutions Co., Ltd. 2026. All rights reserved.***

---

# 概述

Yocto项目（YP）是一个开源协作项目，可帮助开发人员创建基于Linux的定制系统。Yocto也可用于构建基于高通SoC设计的平台的系统。下面将介绍基于高通 **QCS6490** SoC设计的移远通信 **Quectel Pi H1** 智能主控板的Yocto构建。

Quectel Pi H1采用移远通信提供的基于Yocto构建系统的SDK，该SDK基于高通平台进行了深度定制和优化，为开发者提供了完整的BSP（Board Support Package）支持。

# 支持的发行版

Quectel Pi H1目前支持以下Yocto发行版：

## Yocto Linux (qcom-wayland)

移远通信提供的官方Yocto Linux版本，基于高通 **QCS6490** 平台BSP，集成了完整的驱动支持和多媒体功能。

**主要特性：**

- 基于 **Yocto Project** 构建系统

- **DISTRO**：qcom-wayland

- **MACHINE**：qcm6490-idp

- 完整的高通平台驱动支持

- 丰富的多媒体编解码能力（支持4K@60fps）

- 强大的AI算力支持（高达12TOPS）

- 完善的外设接口支持（USB、PCIe、MIPI、HDMI等）

# 构建Quectel Pi H1的Yocto Linux

## 准备工作

在开始构建之前，您需要：

1. **配置开发环境**  
准备Ubuntu 22.04 LTS开发主机并安装必要的工具链。详细的环境配置步骤请参考：

- [开发环境搭建](<开发环境搭建/开发环境搭建.md>)

2. **硬件要求**  
    - x86计算机（四核CPU或更高）  
    - 至少16GB内存  
    - 至少300GB可用磁盘空间（推荐使用SSD）  
    - Ubuntu 22.04（64-bit）操作系统

## 构建流程

完整的Yocto Linux构建流程包括：代码克隆、环境配置、编译和打包等步骤。构建完成后可获得系统镜像、内核、设备树等完整的固件文件。

**详细的构建步骤和操作指南，请参考：**

- [镜像构建](<镜像构建/镜像构建.md>)-包含完整的SDK获取、编译、打包和镜像获取步骤

**注意**  
Yocto构建是一个复杂的过程，首次构建可能需要1~2小时或更长时间，具体取决于您的硬件配置和网络状况。建议使用高性能计算机并确保网络连接稳定。

# 镜像烧录

构建完成后，您可以使用QFIL工具将镜像烧录到Quectel Pi H1开发板。详细的烧录步骤请参考：

- [镜像烧录](<镜像烧录/镜像烧录.md>)

# 参考资源

- **Yocto Project官方网站**：[https://www.yoctoproject.org/](<https://www.yoctoproject.org/>)

- **高通开发者网站**：[https://www.qualcomm.com/developer](<https://www.qualcomm.com/developer>)

- **移远通信技术支持**：获取更多Quectel Pi H1相关技术支持

# **快速访问**

- [开发环境搭建](<开发环境搭建/开发环境搭建.md>)
- [镜像构建](<镜像构建/镜像构建.md>)
- [镜像烧录](<镜像烧录/镜像烧录.md>)
- [远程访问](<远程访问/远程访问.md>)
- [系统工具与应用](<系统工具与应用/系统工具与应用.md>)
- [交叉编译工具链](<交叉编译工具链/交叉编译工具链.md>)
- [设备树文件说明](<设备树文件说明/设备树文件说明.md>)
- [内核编译与更新](<内核编译与更新/内核编译与更新.md>)
- [增加应用程序和第三方库](<增加应用程序和第三方库/增加应用程序和第三方库.md>)
- [性能优化技巧](<性能优化技巧/性能优化技巧.md>)
- [使用指南](<使用指南/使用指南.md>)